home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1997 May / macformat-050.iso / Shareware Plus / Developers / Find_icon folder / Headers / Get_normal_folder_icon.h < prev    next >
Encoding:
C/C++ Source or Header  |  1997-01-25  |  1.9 KB  |  58 lines  |  [TEXT/CWIE]
  1. /*    ---------------------------------------------------------------------------------------------
  2.     Find_icon, code for constructing icon suites for files and folders
  3.     
  4.     by James W. Walker
  5.     preferred e-mail: <mailto:jwwalker@kagi.com>
  6.     alternate e-mail: <mailto:jwwalker@aol.com>, <jim@nisus-soft.com>
  7.     web: <http://users.aol.com/jwwalker/>
  8.     
  9.     File: Get_normal_folder_icon.h
  10.     
  11.     Copyright ©1997 by James W. Walker
  12.     
  13.     You may incorporate this sample code into your applications without
  14.     restriction, though the sample code has been provided "AS IS" and the
  15.     responsibility for its operation is 100% yours.
  16.     If you're going to re-distribute the source, please make it clear
  17.     that the code was descended from James W. Walker's code,
  18.     but that you've made changes.
  19.     ---------------------------------------------------------------------------------------------
  20. */
  21.  
  22. #ifndef __TYPES__
  23.     #include <Types.h>
  24. #endif
  25.  
  26. #ifndef __ICONS__
  27.     #include <Icons.h>
  28. #endif
  29.  
  30. #ifndef __FILES__
  31.     #include <Files.h>
  32. #endif
  33.  
  34. #ifndef    _H_MetaSelector_
  35.     #include "MetaSelector.h"
  36. #endif
  37.  
  38. OSErr    Get_normal_folder_icon(
  39. /* --> */    const CInfoPBRec    *cpb,
  40. /* --> */    MetaSelectorValue    icon_selector,
  41. /* <-- */    Handle    *the_suite
  42. );
  43. /*    ¶ Create an icon suite for a folder, assuming that it does not have
  44.     a custom icon.  This includes finding special icons for the special
  45.     folders found by FindFolder, and shared folders.
  46.     The icons in the suite are not resources, and it is your
  47.     responsibility to dispose of the suite when you are done with it.
  48.  
  49.     cpb                input:    A parameter block describing the folder, filled in
  50.                             by PBGetCatInfo.
  51.     icon_selector    input:    an icon type mask, as defined in <Icons.h>.
  52.                             You can also use the special masks in MetaSelector.h,
  53.                             for instance svLargeThenSmall means to first
  54.                             search for large icons, but if none are found,
  55.                             try for small icons.
  56.     the_suite        output:    The new icon suite.
  57. */
  58.